package com.zjinyin.forum.service;

import com.zjinyin.forum.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: DELL
 * Date: 2023-08-10
 * Time: 15:05
 */

/**
 * 关于帖子的相关接口功能
 */
public interface IArticleService {

    /**
     * 新增一篇帖子
     *
     * @param article 帖子
     */
    @Transactional
    void create(Article article);

    /**
     * 查询首页下所有为删除的文章
     *
     * @return 返回指定文章结合
     */
    List<Article> selectAll();

    /**
     * 根据版块 id 查询指定版块下未删除的文章
     *
     * @param boardId 版块 Id
     * @return 返回指定版块下的所有文章
     */
    List<Article> selectArticleByBoardId(Long boardId);

    /**
     * 根据 id 多变联查指定帖子
     *
     * @param id 帖子 id
     * @return 返回帖子对象
     */
    Article selectArticleByABoardIdAndAId(Long id);

    /**
     * 修改指定帖子
     *
     * @param id      帖子 id
     * @param title   帖子标题
     * @param content 帖子正文
     */
    @Transactional
    void modify(Long id, String title, String content);

    /**
     * 根据帖子 id 直接查询帖子列表
     *
     * @param id 帖子 id
     * @return 返回指定帖子对象
     */
    Article selectById(Long id);

    /**
     * 点赞数 + 1
     *
     * @param id 帖子 id
     */
    @Transactional
    void chickLikeCount(Long id);


    /**
     * 删除指定 id 帖子
     *
     * @param id 帖子 id
     */
    @Transactional
    void deleteById(Long id);


    /**
     * 指定 id 的帖子下回复数 + 1
     * @param id 帖子 id
     */
    @Transactional
    void addOneReplyCountById(Long id);


    /**
     * 根据用户 id 多表联查文章表和用户表, 展示用户发表的未删除的文章
     * @param userId 用户 id
     */
    List<Article> selectArticleByUserId(Long userId);


    List<Article> selectAllArticleByTitle(String title);
}
